Upgrading RTX64 Projects

Projects built with the RTX64 Application Wizard prior to RTX64 2014 with Service Pack 1 do not support debugging. You must add debugger support to these projects manually. In addition, you must upgrade these projects to use the correct version of StampTool for stamping.

To migrate existing projects from RTX64 2014 versions to RTX64 4.x:

To migrate your existing RTX64 projects from RTX64 2014 versions to RTX64 4.x, follow these steps for each RTX64 project:

NOTE: This must be done in a text editor, as the environment variables are found in the .vcxproj XML but not in the Project Properties in Visual Studio. Modifying these settings in Visual Studio can lead to Linker Errors and other issues as a result of the RTX64Platform environment variable not being properly upgraded.

  1. Open the .vcxproj file with a text editor, such as Notepad.
  2. Find all references of the phrase RTX64SDKDIR2 and replace all instances with RTX64SDKDIR4.
  3. Save your changes and exit Notepad.
  4. Open and compile the project in Visual Studio.

To migrate existing projects from pre-RTX64 2014 with Service Pack 1 to RTX64 2014 with Service Pack 1 or later: 

To migrate your existing RTX64 projects forward to RTX64 2014 with SP1 or later, follow these steps for each RTX64 project:

  1. Create a new empty project using the RTSS Template in RTX64 2014 with SP1 or later.
  2. Add your existing source file to it the new RTSS template. This will provide the proper compiler and linker options, along with debug launch and debugging capabilities.

If this is not possible due to the complexity of your application, do the following for each existing RTX64 project (.vcproj file):

  1. Open the file in a text editor, such as Notepad.
  2. Replace the last two lines of the Visual Studio project with the following lines of code:
       <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
	<Import Project="$(RTX64Common)\DebuggerExtensions\IntervalZero.targets"
	Condition="exists('$(RTX64Common)\DebuggerExtensions\IntervalZero.targets')"/>
	<ImportGroup Label="ExtensionTargets">
	</ImportGroup>
  1. Save your changes and exit Notepad.
  2. Open the project in Visual Studio and manually select:

NOTE: Some Windows library names changed between Visual Studio 2012/2013 and Visual Studio 2015. As a result, you may not be able to compile after upgrading a project. To work around this, create a clean RTX64 project in Visual Studio 2015 and copy the list of library names to the project you upgraded.

To upgrade for correct StampTool stamping:

  1. If the previous version of the RTX64 SDK is no longer on the system, open the .vcxproj in question with a text editor and replace all references of RTX64SDKDIR with RTX64SDKDIR<MAJORVERSION>.

This will direct all the Headers and Libs to be imported.

  1. Open your project in Visual Studio.
  2. In the project properties > Build Events > Post-Build Event > Command Line, change the existing StampTool post-build step to the following value:

This will ensure that the correct version of StampTool is stamping the Binary. This needs to be done for the RTSSDebug and RTSSRelease Configurations only.

Related topics: